.TH GPTLget_wallclock_latest 3 "May, 2020" "GPTL"

.SH NAME
GPTLget_wallclock_latest \- Return most recent wallclock start/stop time for a region

.SH SYNOPSIS
.B C/C++ Interface:
.nf
#include <gptl.h>
int GPTLget_wallclock_latest (const char *name, int t, double *value);
.fi

.B Fortran Interface:
.nf
use gptl
integer gptlget_wallclock_latest (character(len=*) name, integer t, real*8 value)
.fi

.SH DESCRIPTION
.B GPTLget_wallclock_latest()
Returns most recent wallclock time from a start/stop pair for region "name"
.IR name.

.SH ARGUMENTS
.TP
.I name
-- existing region name
.TP
.I t
-- thread number. If < 0, return results for the current thread.
.TP
.I *value
-- output 64-bit most recent wallclock time from a start/stop pair for region "name"

.SH RESTRICTIONS
.B GPTLinitialize()
must have been called, and at least one pair of calls to
.B GPTLstart()
and 
.B GPTLstop()
for the desired region.

.SH RETURN VALUE
On success, 0 is returned.
On error, a negative error code is returned and a descriptive message
printed. 

.SH SEE ALSO
.BR GPTLsetoption "(3)" 
